home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 9,300 to 9,399 / 9300.zip / AOLDLs / HTML & Web Tools (MAC) / HTML_ MTX Web Publishing Tool / MTX Tool 1.3.sit / MTX Tool 1.3 / guide / docs / quest.mtx < prev    next >
Text File  |  1996-02-18  |  4KB  |  169 lines
  1. %TITLE Interactive Questions
  2. %IMAGES ../images/
  3. %HOMEURL http://www.med.ufl.edu/medinfo/
  4. %PARENT Table of Contents
  5. %PARENTURL index.html
  6. %INDEX View MTX File
  7. %INDEXURL quest.mtx
  8. %PREVURL tables.html
  9. %NEXTURL slides.html
  10. %AUTHOR Richard Rathe / rrathe@ufl.edu
  11. %AUTHURL rrathe@ufl.edu
  12. %VERSION MTX 1.3 User's Manual / Copyright 1996 by the University of Florida
  13. %PATH http://www.med.ufl.edu/medinfo/mtx/docs/
  14. %MTX 1.3
  15.  
  16. #Introduction
  17.  
  18. Instructional Web pages are much more engaging when you present or reiterate
  19. major teaching points in the form of questions. Questions force the student to
  20. interact with the material and reinforce key concepts. MTX currently supports
  21. three different question formats:
  22.  
  23.     {#Simple##SIMPLE#} - feedback is given all at once with any right or
  24. wrong answer
  25.     {#Progressive##PROG#} - feedback is progressively disclosed with wrong
  26. answers
  27.     {#Multiple Answer##MULTI#} - more than one correct answer is available
  28.  
  29. #Basic Question Format
  30.  
  31. The question mark (?) tag is used to begin each question. The tag is followed by
  32. letters indicating the correct answer (the letter "c" indicates the third choice,
  33. etc.). The text of the question follows on a subsequent line. Questions can
  34. include images. Here is an example of these elements:
  35.  
  36. =  ?c
  37. =  ▓=picture=│
  38. =  This is the text of the question.
  39.  
  40. Questions will be automatically numbered from 1, 2, 3, etc. for each document.
  41.  
  42. Each answer begins with an at sign (@) tag. Each choice is treated as a separate
  43. paragraph. The letters A, B, C, etc. are added automatically. Optional feedback
  44. is provided as a series of indented lines.
  45.  
  46. =  @Red
  47. =     Feedback for Red
  48. =  @Green
  49. =     Feedback for Green
  50. =  @Blue
  51. =     Feedback for Blue
  52.  
  53. There can be as few as 2 choices and as many as 26 (A-Z).
  54.  
  55. #Examples
  56.  
  57. ##Simple Questions#=SIMPLE
  58.  
  59. This is an example of a simple question.
  60.  
  61. ?c
  62. What color is the sky?
  63.  
  64. @Red
  65.     Use this question type when you want to deliver feedback all at once. 
  66. @Green
  67.     The sky is not green.
  68. @Blue
  69.     The sky is blue.
  70.  
  71. ##Progressive Questions#=PROG
  72.  
  73. This is an example of a progressive question. Add a second question mark (?) tag
  74. to add progressive disclosure to a question:
  75.  
  76. =  ?c?
  77.  
  78. ?c?
  79. What color is the sky?
  80.  
  81. @Red
  82.     The sky is sometimes red but more often another color.
  83. @Green
  84.     The sky is not green.
  85. @Blue
  86.     The sky is blue.
  87.     Use this question type when you want to deliver progressive feedback with
  88. each wrong answer.
  89.  
  90. ###Progressive Questions with Custom Prompts
  91.  
  92. This is an example of a progressive question with a custom prompt. Text for the
  93. prompt follows the second question mark (?):
  94.  
  95. =  ?c?Get Real!!
  96.  
  97. ?c?Get Real!!
  98. What color is the sky?
  99.  
  100. @Red
  101.     The sky is sometimes red but more often another color.
  102. @Green
  103.     The sky is not green.
  104. @Blue
  105.     The sky is blue.
  106.     Use this question type when you want to deliver progressive feedback with
  107. each wrong answer.
  108.  
  109. ##Multiple Answer Questions#=MULTI
  110.  
  111. This is an example of a question with two right answers.
  112.  
  113. =  ?bd
  114.  
  115. ?bd
  116. Which of the following are even numbers?
  117.  
  118. @One
  119.     The number 1 is odd.
  120. @Two
  121.     The number 2 is even.
  122. @Three
  123.     The number 3 is odd.
  124. @Four
  125.     The number 4 is even.
  126. @Five
  127.     The number 5 is odd.
  128.  
  129. ##Questions with Images
  130.  
  131. You can use {#pictures#images.html#} or {#hypertext links#hyper.html#} in any
  132. part of a question. Providing feedback with counter example images is one useful
  133. technique.
  134.  
  135. ?b?
  136. {=picture=}
  137.  
  138. This is a picture of:
  139.  
  140. @The Moon
  141.     The moon looks like this:
  142.     {=moon=}
  143. @A Flower
  144.     This is a picture of a water lily.
  145. @Some Trees
  146.     Trees look like this:
  147.     {=trees=}
  148.  
  149. #Files and File Names
  150.  
  151. The questions on this page produce fifteen extra HTML files, one for each
  152. feedback element. The names for these files are assigned automatically when the
  153. MTX file is processed. For greatest {#compatibility#compat.html#}, the length of
  154. these file names is limited to eight characters as follows:
  155.  
  156.     The first four characters of the main page file name
  157.     The letter "Q"
  158.     The question number (1, 2, 3...)
  159.     The answer letter (A, B, C...)
  160.     The ".html" extension
  161.  
  162. For example, the feedback file for the first answer to question 2 is:
  163.  
  164. =  quesQ2A.html
  165.  
  166. Note that these file names are arbitrary and will change as you add, move, or
  167. eliminate questions from the original MTX file. Be sure to update any hypertext
  168. links you make to these files when you edit them.
  169.